home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Applications / gdbm-1.7.3 / source / fetch.c < prev    next >
Text File  |  1994-05-21  |  2KB  |  62 lines

  1. /* fetch.c - Find a key and return the associated data.  */
  2.  
  3. /*  This file is part of GDBM, the GNU data base manager, by Philip A. Nelson.
  4.     Copyright (C) 1990, 1991, 1993  Free Software Foundation, Inc.
  5.  
  6.     GDBM is free software; you can redistribute it and/or modify
  7.     it under the terms of the GNU General Public License as published by
  8.     the Free Software Foundation; either version 2, or (at your option)
  9.     any later version.
  10.  
  11.     GDBM is distributed in the hope that it will be useful,
  12.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.     GNU General Public License for more details.
  15.  
  16.     You should have received a copy of the GNU General Public License
  17.     along with GDBM; see the file COPYING.  If not, write to
  18.     the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  19.  
  20.     You may contact the author by:
  21.        e-mail:  phil@cs.wwu.edu
  22.       us-mail:  Philip A. Nelson
  23.                 Computer Science Department
  24.                 Western Washington University
  25.                 Bellingham, WA 98226
  26.        
  27. *************************************************************************/
  28.  
  29.  
  30. /* AIX demands this be the very first thing in the file. */
  31. #if !defined(__GNUC__) && defined(_AIX)
  32.  #pragma alloca
  33. #endif
  34.  
  35. /* include system configuration before all else. */
  36. #include "autoconf.h"
  37.  
  38. #include "gdbmdefs.h"
  39. #include "extern.h"
  40.  
  41.  
  42. /* Look up a given KEY and return the information associated with that KEY.
  43.    The pointer in the structure that is  returned is a pointer to dynamically
  44.    allocated memory block.  This DBM interface uses the NDBM interface. */
  45.  
  46. datum
  47. fetch (key)
  48.      datum key;
  49. {
  50.   datum  ret_val;        /* The return value. */
  51.  
  52.   /* Free previous dynamic memory, do actual call, and save pointer to new
  53.      memory. */
  54.   ret_val = gdbm_fetch (_gdbm_file, key);
  55.   if (_gdbm_fetch_val != NULL) free (_gdbm_fetch_val);
  56.   _gdbm_fetch_val = ret_val.dptr;
  57.  
  58.   /* Return the new value. */
  59.   return ret_val;
  60.  
  61. }
  62.